home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / tcp_ip / rmail213 / rmailer.man < prev    next >
Text File  |  1993-08-07  |  6KB  |  101 lines
  1.  
  2.    RMAILER(1)(RATS - Radio Amateur Telecommunications Society)RMAILER(1)
  3.  
  4.      NAME
  5.           rmailer - multi-receipient message processor
  6.  
  7.      SYNOPSIS
  8.   rmailer [-r ifil] [-w ofil] [-d ddir] [-l ldir] [-a+] [-s] [-i$] [-t+] hname
  9.  
  10.   fbbrmail ifil
  11.  
  12.      DESCRIPTION
  13.           RMAILER reads a standard PBBS export file (ifil default
  14.           rmailer.exp) consisting of messages for the program to process
  15.           and writes a copy for each of the specified receipients to a
  16.           standard PBBS import file (ofil default rmailer.imp) that the
  17.           PBBS program then imports and distributes.  The program will
  18.           remove the input file on successful completion (unless the -s
  19.           switch is specified).
  20.  
  21.           The local system's heirarchical name (hname) is required to be
  22.           the final argument on the command line. The switches and their
  23.           arguments may appear in any sequence preceeding hname.  The a,
  24.           i, s and t switches may be given via the environmental variable
  25.           RMO (ex.  set RMO=t-a+i$ ).
  26.  
  27.           The determination of the receipient list is driven by the to
  28.           field of the Sx command line of the message as follows:
  29.  
  30.           RMAIL   - The list is contained in a RFC-822 style "To:" line
  31.                     (continuation lines begining with a space or tab
  32.                     permitted) with the first address being "rmail@hname"
  33.                     and containing at least one more address.  The list
  34.                     may have additional RMAIL lists within starting with
  35.                     "rmail@bbs" and ending with "***EOF".
  36.  
  37.           lstname - Where there is a file in the directory ddir (default
  38.                     SYS) named lstname.dst which lists receipients one per
  39.                     line and may include RMAILs as detailed above.
  40.  
  41.           otherTo - Any other to field contents are taken to be a message
  42.                     that has been re-addressed and is to be resent the
  43.                     BBS is picked up from the Sx command line and re-used.
  44.  
  45.           Once the list for the message is determined the new messages are
  46.           created.  The message as received is placed with a timestamp in
  47.           a log file {RMAIL|lstname|RESEND}{YY.MON|.LOG} (YY.MON = 2-digit
  48.           year and three letter month set by -t+, LOG by -t-) in ldir
  49.           (default .).  New messages are generated with prior "R:" headers
  50.           removed and "Resent-Sender:" and new "To:" lines prepended to the
  51.           RFC-822 style headers (if there are no RFC-822 headers then
  52.           "Reply-To:" and "Subject:" are built from the original message and
  53.           also added).  The new S command line is constructed so as to allow
  54.           the BBS to decide B vs P and to force assignment of a new BID/MID
  55.           (MID/BID assignment character set using -ix where x is $ or % or #
  56.           any other value for x to cancel MID forcing).
  57.  
  58.           A confirmation message will be sent to the message originator for
  59.           postings to mailing lists or of RMAILs if *CONFIrm is included as
  60.           an 'addressee'.  An "Address Correction Notice" is returned to the
  61.           sender of a resent message giving the corrected address for future
  62.           reference (suppressed by the -a- switch).  All message senders are
  63.           logged in the ddir directory in a file named "Reply-To.log".  The
  64.           record format is "call call@bbs" one record per line (ROSErver/PRMBS
  65.           v1.78 and later will use this file as the final lookup for mail to
  66.           call at the local system if call is not a registered user).  It
  67.           is suggested to sort and remove dupes from the file occasionaly.
  68.  
  69.           The RMAIL function also supports rmail to a buletin routing 
  70.           with an assigned BID$.  The buletin "address" must be the first
  71.           address on the "To:" line after the "rmail@<bbs>".  The
  72.           assigned BID$ is appended to the "rmail@<bbs>" on the "To:"
  73.           line (e.g.  "To: rmail@kb4cyc.nj.usa$bid_this, users@tribbs,
  74.           kb2ear@kb2ear, kb4cyc").
  75.  
  76.           RMAILER wil also function as a server under the F6FBB BBS.  To
  77.           enable this method of operation the program is renamed as
  78.           FBBRMAIL instead of RMAILER (or any other name containing "FBB")
  79.           or the letter 'F' is included in the value of the RMO environmental
  80.           variable ('F' is not available on the command line due to the
  81.           constraints on FBB server programs).  For the FBB server the log
  82.           and distribution files are placed in the LOG and FWD sub-directories
  83.           of the SYSTEM directory respectively.  As with any server entries
  84.           for the appropriate to fields (RMAIL and any mailing lists) are
  85.           added to INIT.SRV (such as:  RMAIL FBBRMAIL.EXE).
  86.  
  87.           Messages to a distribution list with a subject begining with LIST, 
  88.           SENDLIST, SUBSCRIBE, ADD, UNSUBSCRIBE or REMOVE will perform the
  89.           indicated function rather than expand (subject to controls set by
  90.           *NOLIST or *RESTRICT entries in the list).
  91.  
  92.           If the second 'address' on the "To:" line of an incomming RMAIL
  93.           is *NOXTO then that "To:" line is suppressed rather than sent
  94.           along as an "X-To:" line in the header of the expanded message.
  95.  
  96.      AUTHOR
  97.           Frank Warren (KB4CYC)
  98.  
  99.      CURRENT RELEASE
  100.           2.13
  101.